home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / signof20.arc / SIGNOFF.DOC < prev    next >
Text File  |  1987-11-27  |  8KB  |  191 lines
  1.  
  2.  
  3.  
  4.                                   ---SIGNOFF---
  5.  
  6.           OVERVIEW
  7.  
  8.           I got  a hold  of two  programs that  seem to  work fine.  One was
  9.           called "Thought of the day"  and  the  other  was  called "Today".
  10.           Both worked  ok, however neither of the programs did what I wanted
  11.           so I have rewritten a program that used  the data  files from both
  12.           programs.
  13.  
  14.           What I  wanted was a program that would add a lot or just a little
  15.           stuff in my "Script0" file as  a signoff  message,   you know with
  16.           the  ";"  in  each  line  so  my  script  file  would  not ask any
  17.           questions, and print a message to the user.  So here goes...
  18.  
  19.           Oh yea, I forgot; Aren't you supposed to say something  like this:
  20.           "This  is   a  free  program",  don't  send  any  money,  marriage
  21.           proposals, or  gifts, just  give me  credit all  over your PCBoard
  22.           files, bulletins  and welcome  messages.  No not really,  <<grin>>
  23.           just use it if you find it useful, and you surely will,  sense you
  24.           can change it any way you wish.
  25.  
  26.           Have you ever thought it would be nice to know what interesting
  27.           things happened on a date in history?  When famous, or not so
  28.           famous,  birthdays  occurred?    SIGNOFF  will tell you.  When the
  29.           program is run, in your event.sys  file  it  looks  at  the system
  30.           date,  then  tells  you  what  things of interest happened on that
  31.           date. 
  32.  
  33.  
  34.           INSTALLATION
  35.  
  36.           SIGNOFF is distributed as  an  archive  file(SIGNOFF.ARC)  and you
  37.           must have  PKX35A35, or  something else that will work, to extract
  38.           the required files.  The files comprising the SIGNOFF system are:
  39.  
  40.  
  41.  
  42.                  SIGNOFF.DOC - This file
  43.                  SIGNOFF.EXE - The program
  44.                  SIGNOFF.MON - where MON is JAN through DEC.  These files 
  45.                                contain all the interesting trivia stuff.
  46.                                (You can change it).
  47.                  SIGNOFF.TXT - This file is the Quotes file, (You can change
  48.                               it)
  49.                  SIGNOFF.CNT - This file is the Header and  counter file...I
  50.                               don't like this file, but what the hey.
  51.                  SIGNOFF.OUT - The output file, Copy it to Script0 or  what 
  52.                              ever.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           (NOTE: All  files must be in the default or it's own subdir or bad
  59.           stuff will happen to you, like it won't work)
  60.  
  61.  
  62.           After printing this DOC file, you need not keep it on disk but you
  63.           will need the EXE and all the other  files.   They MUST  all be in
  64.           the same directory on your disk.  Why not call it SIGNOFF?
  65.  
  66.  
  67.  
  68.           To install  SIGNOFF from  the root  directory, with ARC available,
  69.           just unarc into a subdir and type signoff.
  70.  
  71.  
  72.           To run it from your EVENT.SYS you would insert these three lines:
  73.  
  74.  
  75.                  cd \SIGNOFF
  76.                  SIGNOFF
  77.                  cd \PCB
  78.  
  79.  
  80.           This example would change directories to  SIGNOFF's directory, run
  81.           the program,  clearing the  screen at the beginning and return you
  82.           to the EVENT.SYS file at the end.
  83.  
  84.  
  85.  
  86.           CUSTOMIZING
  87.           SIGNOFF has one data file for each month  of the  year.   They are
  88.           named   SIGNOFF.JAN,   .FEB,   .MAR   etc,  and  one  file  called
  89.           SIGNOFF.TXT.   Your  important  dates  aren't  scattered  among 12
  90.           files.  All files are plain vanilla ASCII in this format:
  91.  
  92.  
  93.  
  94.           Signoff.jan - dec:
  95.  
  96.           Column 1:        The record type which can be a B for birthdays,
  97.                            S for special dates in history.
  98.  
  99.           Cols 2-5:        Month and day as MMDD with leading zeros.  Zeros
  100.                            for either month or day cause ALL months or days
  101.                            to match when being scanned.  For example  0101
  102.                            would match the first of January while 0401
  103.                            would match the first of April.
  104.  
  105.           Cols 6-9:        The full year of the event as four digits
  106.                            1987 = you know, 1890 = the year of 1890.
  107.  
  108.           Cols 11-70       The message to display for this date.
  109.  
  110.  
  111.  
  112.                --EXAMPLES--
  113.  
  114.  
  115.                *mmddyyyy Birthdays
  116.                *--------
  117.                B09011875 Edgar Rice Burroughs, novelist, Ah-ee-ah-ee-ah!
  118.                B09021838 Queen Liliuokalani (last queen of Hawaii).
  119.                B09021952 Jimmy Connors, tennis brat
  120.                *mmddyyyy Events
  121.                *--------
  122.                S09011939 Germany invades Poland, starts World War II.
  123.                S09011952 Sutro Baths purchased by George Whitney.
  124.                S09011987 Labor Day, a legal holiday
  125.                S09021620 The Mayflower sets sail from Plymouth with
  126.                S09021620 102 Pilgrims.
  127.  
  128.  
  129.           Leave the headings in or you may get a nasty surprise.
  130.  
  131.  
  132.           SIGNOFF.TXT
  133.  
  134.           Leave the  format as  is in this file also, however both files can
  135.           be changed or added to as you like. Just make the headers  as they
  136.           are shown.
  137.  
  138.           $what's tennis without a racket?   RACKET???
  139.  
  140.           The "$"  starts a new quote and only two lines will be read in the
  141.           .out file... So go ahead  and  add  three  and  see  if  I'm right
  142.           <grin>.   The reason for two lines is PCBoard adds some other junk
  143.           to the bottom of my good stuff  and this  will cause  it to scroll
  144.           off the  top, and  your user  won't get  to see  "the good stuff",
  145.           unless he's a fast reader.
  146.  
  147.           A word about the SIGNOFF.CNT file.   It  contains several  bits of
  148.           information, here is the format:
  149.  
  150.  
  151.  
  152.           "Happy Birthday To..."
  153.           "On This Day In..."
  154.           "Remember !"
  155.           2
  156.           ***************************************
  157.                 Date Last Updated:   11/22/1987
  158.                 Time Last Updated:   16:49:34
  159.             Birthday & Event File:   Signoff.nov
  160.           Signoff.txt file # read:   2
  161.  
  162.  
  163.  
  164.  
  165.           The  first  three  lines  are  output  to  the SIGNOFF.OUT file as
  166.           headders for the three sections.   These lines  can be  changed to
  167.           what ever you would like to say.  Each line is output as a headder
  168.           for each of the three sections.  Don't  try to  put more  than one
  169.           line for each headder.
  170.  
  171.           The 4th.  line is  the numeric value of the line that is output as
  172.           the "remember" statment.  You can  start this  number anywhere you
  173.           like.  It will advance by one each time the program is execuited.
  174.  
  175.           Under the  *************, line  are just  some stuff that tell you
  176.           which, where, when all the good stuff happened.. It might help you
  177.           if by some remote chance things get all fouled up.. As we all know
  178.           they do.  The last four  lines  are  created  at  the  end  of the
  179.           signoff execution.  So if problems occur these line might tell you
  180.           when the error occured.
  181.  
  182.  
  183.                                -Larry Bugg-
  184.  
  185.                                7620 N. W. 20th. Street
  186.                                Bethany, Oklahoma  73008
  187.                                (405) 789-4180   (After 6:00 PM CST)
  188.                           BBS: (405) 787-7442   (24 hours)
  189.  
  190.  
  191.